home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 081-090 / amok90 / filerexx1.3 / filerexx.dok < prev    next >
Text File  |  1993-11-04  |  8KB  |  239 lines
  1.  
  2. Dokumentation zu FileRexx 1.3
  3. =============================
  4. Programm und Dokumentation sind © Copyright 1993 by Michael 'Mick' Hohmann
  5. und hartmut Goebel.
  6.  
  7. IMPORT StdDisclaimer; (* kurz: Benutzung auf eigene Gefahr *) FileRexx
  8. wurde sorgfältig getestet, aber es können natürlich trotzdem noch diverse
  9. Fehler auftreten.
  10.  
  11. FileRexx v1.3 ist Freeware. Es ist aber nicht erlaubt, es zu kommerziellen
  12. Zwecken ohne unsere schriftliche Erlaubnis zu benutzen. Änderungen müssen
  13. dokumentiert werden. Dabei müssen unser Name und unser Copyright erhalten
  14. bleiben. Es darf auf nicht-kommerziellem Weg weitergegeben werden, solange
  15. die folgenden Bedingungen erfüllt sind:
  16.  
  17.   * Ausführbares Programm und Dokumentation müssen zusammen
  18.     weitergegeben werden (FileRexx, FileRexx.dok, FR-RexxStrings.ttx,
  19.     FR-Test.rexx, RequestFile.ttx, TTX_Dragon.dfn, FileRexx.mod,
  20.     MoreIntuition.mod und SimpleRexx.mod). Die Dateien müssen unverändert
  21.     weitergegeben werden!
  22.  
  23.   * PD-Serien: Die Disketten, die FileRexx enthalten, dürfen in Deutschland
  24.     nicht mehr als 5 DM kosten.
  25.     Ansonsten darf der Preis, den Fred Fish für eine einzelne seiner
  26.     AmigaLibDisks verlangt, nicht überschritten werden.
  27.  
  28.  
  29. FileRexx läuft nur mit AmigaOS V37 oder höher (das ist 2.04 oder höher).
  30.  
  31.  
  32. Zusammenfassung
  33. ===============
  34. FileRexx öffnet einen ASL-FileRequester auf dem vordersten PubScreen, und
  35. schreibt die/das ausgewählte Datei/Verzeichniss nach StdOut, in eine
  36. Env-Var (falls angegeben), oder in eine ARexx-Variable (falls FileRexx
  37. einen Rexx-Host geöffnet hat.
  38.  
  39. Beendet wird das Programm (falls kein Rexx-Host geöffnet wurde) einfach
  40. dadurch, daß der FileRequester mit "CANCEL" beantwortet wird. Falls ein
  41. Rexx-Host geöffnet wurde, kann das Programm durch folgendes beendet
  42. werden:
  43.    - den ARexx-Befehl 'Quit' an den Rexx-Host schicken
  44.    - ein CTRL-C an FileRexx senden
  45.    - FileRexx nochmal mit dem gleichen PortNamen als Argument aufrufen
  46.  
  47. Die Größe des FileRequesters passt sich, falls nicht durch Argumente
  48. anders angegeben automatisch an die aktuelle "visible Size" (der in
  49. Overscan eingestellte Bereich) des Screens an.
  50.  
  51. Geschrieben habe ich dieses Programm hauptsächlich um von TurboText aus
  52. den ASL-Requester (und dadurch auch MagicFilerRequester, ReqTools)
  53. benutzen zu können. Deshalb ist auch ein Makro und eine Definition-Datei
  54. für TurboText dabei. Das Makro für TurboText mag auch als Beispiel dafür
  55. dienen, wie man FileRexx von ARexx aus anspricht.
  56.  
  57.  
  58. Inhalt
  59. ======
  60.  
  61. FileRexx           - Das eigentliche Programm
  62. FileRexx.dok       - Die Anleitung (naja, halt dieser Text ¦=)
  63. FR-RexxStrings.ttx - Eine Sammlung von ARexx-*Strings* für die
  64.                      TurboText-Definitiondatei (ist schneller als Makros,
  65.                      aber FileRexx _muß_ vorher gestartet werden
  66. FR-Test.rexx       - Ein simples Test-Makro
  67. RequestFile.ttx    - ARexx-Makro, welches für dir TTX-Definitonsdatei
  68.                      "TTX_Dragon.dfn" benötigt wird. (FileRexx wird
  69.                      geladen, falls es sich noch nicht im Speicher
  70.                      befindet)
  71. TTX_Dragon.dfn     - Meine TurboText-Definitiondatei, noch ohne
  72.                      Rexx-Strings, deshalb wird RequestFile benötigt
  73. FileRexx.mod       - Der Quelltext des Hauptprogrammes
  74. MoreIntuition.mod  - Ein Zusatzmodul welches sich um das Locking des
  75.                      PubScreens kümmert
  76. SimpleRexx.mod     - Der Hauptteil der ARexx-Schnittstelle befindet sich
  77.                      in diesem Modul
  78.  
  79.  
  80. Aufruf
  81. ======
  82. (vom CLI aus):
  83.  
  84. FileRexx [FILE name] [PAT | PATTERN string ] [TITLE string] [TOP number]
  85.          [LEFT number] [WIDTH number] [HEIGHT number] [PS | PUBSCREEN
  86.          name] [ENVVAR name] [LOCAL] [SM | SAVEMODE] [DRAWERSONLY] [RX |
  87.          REXXHOST] [PORTNAME name] [HELP]
  88.  
  89. (von ARexx aus):
  90.  
  91. GETFILE,
  92. GETFILESAVE,
  93. GETDIR   [FILE name] [PAT | PATTERN string ] [TITLE string] [TOP number]
  94.          [LEFT number] [WIDTH number] [HEIGHT number] [PS | PUBSCREEN
  95.          name] [VAR name]
  96.  
  97. FILE name
  98. ---------
  99. Dient als Voreinstellung für den Datei- und Verzeichnisnamen.
  100.  
  101. PAT | PATTERN string
  102. --------------------
  103. Wird hier ein Pattern angegeben, wird der FileRequester mit einem
  104. Pattern-Gadget geöffnet, und es werden nur die Dateien angezeigt die zu
  105. dem Pattern passen.
  106.  
  107. TITLE string
  108. ------------
  109. Hiermit wird der Fenster-Titel des FileRequesters angegeben.
  110.  
  111. TOP number, LEFT number, WIDTH number, HEIGHT number
  112. ----------------------------------------------------
  113. Normalerweise öffnet wird der FileRequester mit einem Seiten- und
  114. Höhenverhältnis geöffnet, die zu der aktuellen "visible Size" (der in
  115. Overscan eingestellte Bereich) des Screens passen. Falls dies nicht
  116. gewünscht ist, kann durch diese Argumente eine andere Größe und Position
  117. bestimmt werden. Nur durch WIDTH oder HEIGHT wird die Größe des
  118. FileRequesters beeinflusst. Wenn nur eine von diesen zwei Argumenten
  119. angegeben wird, wird die jeweils andere vom Programm berechnet.
  120.  
  121. PS | PUBSCREEN name
  122. -------------------
  123. Der FileRequester öffnet sich normalerweise automatisch auf dem vordersten
  124. PubScreen. Da es aber manchmal sinnvoll sein kann, wenn sich der
  125. FileRequester nur auf einem bestimmten Screen öffnet, kann hiermit der
  126. Name des PubScreens angegeben werden.
  127.  
  128. ENVVAR name
  129. -----------
  130. Wenn hier ein Name angegeben wurde, legt FileRexx den ausgewählten
  131. Filenamen in eine Environment-Variable ab.
  132.  
  133. LOCAL
  134. -----
  135. Wenn dieser Schalter und ein Environment-Name angegeben werden, legt
  136. FileRexx eine lokale Environment-Variable an. Ansonsten wird eine globale
  137. Environment-Variable erzeugt.
  138.  
  139. SM | SAVEMODE
  140. -------------
  141. Der ASL-Filerequester wird im "SaveMode" geöffnet. D.h. der
  142. Dateiauswahlbereich wird invertiert dargestellt.
  143.  
  144. DRAWERSONLY
  145. -----------
  146. Es werden nur Verzeichnisse zur Auswahl angeboten.
  147.  
  148. RX | REXXHOST
  149. -------------
  150. Das Programm öffnet einen Rexx-Host, und kann darüber angesprochen werden.
  151. Folgende ARexx-Commandos stehen zur Verfügung:
  152.  
  153.   GETFILE - genauso wie der normale Aufruf vom CLI aus
  154.  
  155.   GETFILESAVE - genauso wie der Aufruf vom CLI mit der Option SAVEMODE
  156.  
  157.   GETDIR - genauso wie der Aufruf vom CLI mit der Option DRAWERSONLY
  158.  
  159.   QUIT - entfernt das Programm (und den Host) aus dem Speicher
  160.  
  161. Den ersten drei Befehlen können obenstehende Argumente übergeben werden.
  162. Die Parameter der Argumente entsprechen denen des CLI-Aufrufes.
  163.  
  164. PORTNAME name
  165. -------------
  166. Normalerweise heißt der Rexx-Host, den FileRexx öffnet, "FILEREXX". Falls
  167. dies nicht erwünscht ist, oder FileRexx einen zweiten Rexx-Host öffnen
  168. soll, dann kann/muß man mit diesem Argument eine Namen für den Rexx-Host
  169. angeben. Jedoch muß der Name des Rexx-Hosts eindeutig sein, d.h. es darf
  170. kein anderer Port mit dem angegebenen Namen existieren.
  171.  
  172. HELP
  173. ----
  174. Zeigt einen kurzen Hilfstext an.
  175.  
  176.  
  177. Beispiel
  178. ========
  179.  
  180.  FileRexx ENV:sys/palette.prefs PAT=#?.prefs
  181.  
  182.  
  183. History
  184. =======
  185. v1.3    Erste Veröffentlichung
  186. v1.2    Interne Release
  187. v1.1    Rexx-Host eingebaut
  188. v1.0    Erste verwendbare Version :-)
  189. v0.x    diverse Versuche...
  190.  
  191.  
  192. Zukunft
  193. =======
  194. - Von der Workbench aus aufrufbar (weiß nicht, ob das sinnvoll ist, wenn
  195.   es jemand unbedingt benötig, soll er/sie sich einfach mit mir in
  196.   Verbindung setzen...)
  197.  
  198.  
  199. Bekannte Probleme/Bugs
  200. ======================
  201. Bis jetzt keine...
  202.  
  203.  
  204. Author
  205. ======
  206. Im Usenet erreicht man mich unter:
  207.  
  208.    mickh@imart.franken.de
  209.  
  210. Oder mit der Bundesp*st (Rückporto bitte!):
  211.  
  212.    Michael-W. Hohmann
  213.    Carl-Schilling-Str. 10
  214.    D-8701 Kirchheim
  215.  
  216. Viel Spass!
  217.  
  218.  
  219. Danksagung
  220. ==========
  221. Der ARexx-Host wäre ohne Hilfe von hartmut Goebel nicht so schnell
  222. entstanden (wahrscheinlich sogar garnicht !=). Auch sonst hat mir Harmut
  223. sehr viel beim Debuggen geholfen.
  224.  
  225. Die folgenden Leute haben mir mit diversen Anregungen und Bug-Reports
  226. sehr geholfen:
  227.  
  228.   Kai Bolay
  229.   Bernhard Möllemann
  230.   Franz-Josef Reichert
  231.   Steffen Reith
  232.   Uwe Röhm
  233.   Fridtjof Siebert
  234.   Jürgen Weinelt
  235.  
  236. und Oliver Knorr für die leckeren Erdnüße ...                       ¦=)
  237.  
  238. Vielen Dank euch allen.
  239.